home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / il_c / ilHwVisual.z / ilHwVisual
Encoding:
Text File  |  2002-10-03  |  13.3 KB  |  397 lines

  1.  
  2.  
  3.  
  4. iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll - an X Visual
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      This is a base class
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <il/ilCdefs.h>
  16.  
  17. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      The ilHwVisual object is filled in by the ilHwConnection::findVisual*
  19.      methods. It provides an easy way to decode the attributes of an X Visual.
  20.  
  21. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  22.      XXXX aaaattttttttrrrriiiibbbbuuuutttteeee qqqquuuueeeerrrriiiieeeessss
  23.  
  24.           XVisualInfo* ilHwVisualGetVisualInfo(ilHwVisual *obj)
  25.           GLXFBConfigSGIX ilHwVisualGetFBConfig(ilHwVisual *obj)
  26.           Visual* ilHwVisualGetVisual(ilHwVisual *obj)
  27.           int ilHwVisualGetClass(ilHwVisual *obj)
  28.           VisualID ilHwVisualGetVisualID(ilHwVisual *obj)
  29.           int ilHwVisualGetDepth(ilHwVisual *obj)
  30.           int ilHwVisualGetColormapSize(ilHwVisual *obj)
  31.           unsigned long ilHwVisualGetRedMask(ilHwVisual *obj)
  32.           unsigned long ilHwVisualGetGreenMask(ilHwVisual *obj)
  33.           unsigned long ilHwVisualGetBlueMask(ilHwVisual *obj)
  34.  
  35.      CCCCoooommmmppppoooonnnneeeennnntttt ssssiiiizzzzeeee qqqquuuueeeerrrriiiieeeessss
  36.  
  37.           int ilHwVisualGetComponentSize(ilHwVisual *obj)
  38.           int ilHwVisualGetRedSize(ilHwVisual *obj)
  39.           int ilHwVisualGetGreenSize(ilHwVisual *obj)
  40.           int ilHwVisualGetBlueSize(ilHwVisual *obj)
  41.           int ilHwVisualGetAlphaSize(ilHwVisual *obj)
  42.  
  43.      VVVViiiissssuuuuaaaallll ccccaaaappppaaaabbbbiiiilllliiiittttyyyy qqqquuuueeeerrrriiiieeeessss
  44.  
  45.           int ilHwVisualIsDoubleBuffer(ilHwVisual *obj)
  46.           int ilHwVisualIsStereo(ilHwVisual *obj)
  47.           int ilHwVisualIsRgb(ilHwVisual *obj)
  48.           int ilHwVisualIsColorIndex(ilHwVisual *obj)
  49.           int ilHwVisualDoesOpenGL(ilHwVisual *obj)
  50.           int ilHwVisualHasDepth(ilHwVisual *obj)
  51.           int ilHwVisualHasStencil(ilHwVisual *obj)
  52.           int ilHwVisualHasAccum(ilHwVisual *obj)
  53.           int ilHwVisualHasPbuffer(ilHwVisual *obj)
  54.           int ilHwVisualHasAlpha(ilHwVisual *obj)
  55.           int ilHwVisualGetVisualAttributes(ilHwVisual *obj)
  56.           int ilHwVisualGetLevel(ilHwVisual *obj)
  57.  
  58.      MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))
  71.  
  72.  
  73.  
  74.           iflColorModel ilHwVisualGetColorModel(ilHwVisual *obj)
  75.  
  76.  
  77. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  78.      ddddooooeeeessssOOOOppppeeeennnnGGGGLLLL(((())))
  79.  
  80.           int ilHwVisualDoesOpenGL(ilHwVisual *obj)
  81.  
  82.  
  83.           This method returns true if the Visual supports OpenGL rendering.
  84.  
  85.      ggggeeeettttAAAAllllpppphhhhaaaaSSSSiiiizzzzeeee(((())))
  86.  
  87.           int ilHwVisualGetAlphaSize(ilHwVisual *obj)
  88.  
  89.  
  90.           This method returns the alpha component size; if OpenGL is supported
  91.           on this visual the value will be the true internal resolution,
  92.           otherwise it will be zero since X doesn't support an alpha
  93.           component.
  94.  
  95.      ggggeeeettttBBBBlllluuuueeeeMMMMaaaasssskkkk(((())))
  96.  
  97.           unsigned long ilHwVisualGetBlueMask(ilHwVisual *obj)
  98.  
  99.  
  100.           This method returns the blue mask value from the XVisualInfo.
  101.  
  102.      ggggeeeettttBBBBlllluuuueeeeSSSSiiiizzzzeeee(((())))
  103.  
  104.           int ilHwVisualGetBlueSize(ilHwVisual *obj)
  105.  
  106.  
  107.           This method returns the blue component size; if OpenGL is supported
  108.           on this visual the value will be the true internal resolution,
  109.           otherwise it is just derived from the visual depth and class.
  110.  
  111.      ggggeeeettttCCCCllllaaaassssssss(((())))
  112.  
  113.           int ilHwVisualGetClass(ilHwVisual *obj)
  114.  
  115.  
  116.           This return the class of this Visual (e.g. TrueColor, PseudColor,
  117.           etc.).
  118.  
  119.      ggggeeeettttCCCCoooolllloooorrrrmmmmaaaappppSSSSiiiizzzzeeee(((())))
  120.  
  121.           int ilHwVisualGetColormapSize(ilHwVisual *obj)
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))
  137.  
  138.  
  139.  
  140.           This method returns the colormap size from the XVisualInfo.
  141.  
  142.      ggggeeeettttCCCCoooolllloooorrrrMMMMooooddddeeeellll(((())))
  143.  
  144.           iflColorModel ilHwVisualGetColorModel(ilHwVisual *obj)
  145.  
  146.  
  147.           This method returns the IL equivalent color model for this visual.
  148.  
  149.      ggggeeeettttCCCCoooommmmppppoooonnnneeeennnnttttSSSSiiiizzzzeeee(((())))
  150.  
  151.           int ilHwVisualGetComponentSize(ilHwVisual *obj)
  152.  
  153.  
  154.           This method returns the component size of this Visual as seen by X.
  155.  
  156.      ggggeeeettttDDDDeeeepppptttthhhh(((())))
  157.  
  158.           int ilHwVisualGetDepth(ilHwVisual *obj)
  159.  
  160.  
  161.           This method returns the depth of this visual.
  162.  
  163.      ggggeeeettttFFFFBBBBCCCCoooonnnnffffiiiigggg(((())))
  164.  
  165.           GLXFBConfigSGIX ilHwVisualGetFBConfig(ilHwVisual *obj)
  166.  
  167.  
  168.           This method returns the FBConfig for this visual if there is one,
  169.           NULL otherwise.
  170.  
  171.      ggggeeeettttGGGGrrrreeeeeeeennnnMMMMaaaasssskkkk(((())))
  172.  
  173.           unsigned long ilHwVisualGetGreenMask(ilHwVisual *obj)
  174.  
  175.  
  176.           This method returns the green mask value from the XVisualInfo.
  177.  
  178.      ggggeeeettttGGGGrrrreeeeeeeennnnSSSSiiiizzzzeeee(((())))
  179.  
  180.           int ilHwVisualGetGreenSize(ilHwVisual *obj)
  181.  
  182.  
  183.           This method returns the green component size; if OpenGL is supported
  184.           on this visual the value will be the true internal resolution,
  185.           otherwise it is just derived from the visual depth and class.
  186.  
  187.      ggggeeeettttLLLLeeeevvvveeeellll(((())))
  188.  
  189.           int ilHwVisualGetLevel(ilHwVisual *obj)
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))
  203.  
  204.  
  205.  
  206.           This method returns the level of this visual; zero indicates a
  207.           normal visual, other values are for underlay and overlay visuals.
  208.  
  209.      ggggeeeettttRRRReeeeddddMMMMaaaasssskkkk(((())))
  210.  
  211.           unsigned long ilHwVisualGetRedMask(ilHwVisual *obj)
  212.  
  213.  
  214.           This method returns the red mask value from the XVisualInfo.
  215.  
  216.      ggggeeeettttRRRReeeeddddSSSSiiiizzzzeeee(((())))
  217.  
  218.           int ilHwVisualGetRedSize(ilHwVisual *obj)
  219.  
  220.  
  221.           This method returns the red component size; if OpenGL is supported
  222.           on this visual the value will be the true internal resolution,
  223.           otherwise it is just derived from the visual depth and class.
  224.  
  225.      ggggeeeettttVVVViiiissssuuuuaaaallll(((())))
  226.  
  227.           Visual* ilHwVisualGetVisual(ilHwVisual *obj)
  228.  
  229.  
  230.           This method returns the X Visual* for this ilHwVisual.
  231.  
  232.      ggggeeeettttVVVViiiissssuuuuaaaallllAAAAttttttttrrrriiiibbbbuuuutttteeeessss(((())))
  233.  
  234.           int ilHwVisualGetVisualAttributes(ilHwVisual *obj)
  235.  
  236.  
  237.           This method returns the 'ilHwVisualAttributes' attributes.  See
  238.           <il/ilHwConnection.h> for a defintion of these attributes.
  239.  
  240.      ggggeeeettttVVVViiiissssuuuuaaaallllIIIIDDDD(((())))
  241.  
  242.           VisualID ilHwVisualGetVisualID(ilHwVisual *obj)
  243.  
  244.  
  245.           This method returns the VisualID of this visual.
  246.  
  247.      ggggeeeettttVVVViiiissssuuuuaaaallllIIIInnnnffffoooo(((())))
  248.  
  249.           XVisualInfo* ilHwVisualGetVisualInfo(ilHwVisual *obj)
  250.  
  251.  
  252.           This method returns the XVisualInfo* for this visual.
  253.  
  254.      hhhhaaaassssAAAAccccccccuuuummmm(((())))
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))
  269.  
  270.  
  271.  
  272.           int ilHwVisualHasAccum(ilHwVisual *obj)
  273.  
  274.  
  275.           Returns TRUE if this visual has an accumumlation buffer.
  276.  
  277.      hhhhaaaassssAAAAllllpppphhhhaaaa(((())))
  278.  
  279.           int ilHwVisualHasAlpha(ilHwVisual *obj)
  280.  
  281.  
  282.           Returns TRUE if this visual has an alpha component.
  283.  
  284.      hhhhaaaassssDDDDeeeepppptttthhhh(((())))
  285.  
  286.           int ilHwVisualHasDepth(ilHwVisual *obj)
  287.  
  288.  
  289.           Returns TRUE if this visual has an depth buffer.
  290.  
  291.      hhhhaaaassssPPPPbbbbuuuuffffffffeeeerrrr(((())))
  292.  
  293.           int ilHwVisualHasPbuffer(ilHwVisual *obj)
  294.  
  295.  
  296.           Returns TRUE if this visual is usable as a p-buffer.
  297.  
  298.      hhhhaaaassssSSSStttteeeennnncccciiiillll(((())))
  299.  
  300.           int ilHwVisualHasStencil(ilHwVisual *obj)
  301.  
  302.  
  303.           Returns TRUE if this visual has stencil planes.
  304.  
  305.      iiiissssCCCCoooolllloooorrrrIIIInnnnddddeeeexxxx(((())))
  306.  
  307.           int ilHwVisualIsColorIndex(ilHwVisual *obj)
  308.  
  309.  
  310.           This method returns true if this is a color-index visual.
  311.  
  312.      iiiissssDDDDoooouuuubbbblllleeeeBBBBuuuuffffffffeeeerrrr(((())))
  313.  
  314.           int ilHwVisualIsDoubleBuffer(ilHwVisual *obj)
  315.  
  316.  
  317.           This method returns true if this is a double buffered visual.
  318.  
  319.      iiiissssRRRRggggbbbb(((())))
  320.  
  321.           int ilHwVisualIsRgb(ilHwVisual *obj)
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllHHHHwwwwVVVViiiissssuuuuaaaallll((((3333))))
  335.  
  336.  
  337.  
  338.           This method returns true if this is a TrueColor or DirectColor
  339.           visual.
  340.  
  341.      iiiissssSSSStttteeeerrrreeeeoooo(((())))
  342.  
  343.           int ilHwVisualIsStereo(ilHwVisual *obj)
  344.  
  345.  
  346.           This method returns true if this is a stereo visual.
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                                                                         PPPPaaaaggggeeee 6666
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.